ネット銀聯決済 API一覧
HTTP仕様（.idPass）
| Request header |
Content-Type: application/x-www-form-urlencoded;charset=windows-31j |
|
|---|---|---|
| Method |
POST |
|
| Response header |
Content-Type: text/plain;charset=windows-31j |
|
| Status Code |
200：常に200を返却 |
|
EntryTranUnionpay 取引登録
取引IDと取引パスワードの発行を行い、取引を開始します。
※ネット銀聯決済では、仮売上(AUTH)が成功した場合でも、その後の通貨レート変動の影響により、実売上がエラーとなる場合があります。
このため、当社では仮売上／実売上の使用を推奨しておりません。即時売上(CAPTURE)の使用をお勧めします。
リクエスト
| ShopID | 必須 半角英数13桁
ショップID
|
|
|---|---|---|
| ShopPass | 必須 半角英数64桁
ショップパスワード
|
|
| OrderID | 必須 半角英数記号27桁
オーダーID
|
|
| JobCd | 必須
処理区分 AUTH：仮売上 |
|
| Amount | 必須 半角数字8桁
利用金額
|
|
| Tax | 半角数字7桁
税送料税送料を指定した場合は、利用金額＋税送料が決済金額となります。 |
|
URL
/payment/EntryTranUnionpay.idPassリクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&OrderID=ORDER0000001&JobCd=AUTH&Amount=100レスポンス
レスポンスパラメータ：正常系
OrderID=ORDER0000001&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813レスポンスパラメータ：異常系
ErrCode=E01&ErrInfo=E01040001ExecTranUnionpay 決済実行
決済取引で必要となるトークンと遷移URLを返却します。
リクエスト
| ShopID | 必須 半角英数13桁
ショップID
|
|
|---|---|---|
| ShopPass | 必須 半角英数64桁
ショップパスワード
|
|
| AccessID | 必須 半角英数32桁 固定
取引ID
|
|
| AccessPass | 必須 半角英数32桁 固定
取引パスワード
|
|
| OrderID | 必須 半角英数記号27桁
オーダーID
|
|
| CommodityName | 半角英数255桁
商品名半角英数＋記号(マイナス、アンダーライン、ドット、半角スペース)のみ使用可能です。 |
|
| ClientField1 | 全半角100バイト
加盟店自由項目1
|
|
| ClientField2 | 全半角100バイト
加盟店自由項目2
|
|
| ClientField3 | 全半角100バイト
加盟店自由項目3
|
|
| ClientFieldFlag | 半角数字1桁 固定
加盟店自由項目返却フラグ 以下のいずれかを設定します。 |
|
| RetURL | 必須 半角英数記号2048桁
決済結果戻しURL 加盟店様が当サービスから決済結果を受信する結果受信URLを設定します。 |
|
| ErrorRcvURL | 必須 半角英数記号2048桁
処理NG時URL 加盟店様が当サービスから処理失敗となった結果を受信する処理NG時URLを設定します。 |
|
URL
/payment/ExecTranUnionpay.idPassリクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001&RetURL=https://example.com/receive/success&ErrorRcvURL=https://example.com/receive/errorレスポンス
正常
| AccessID | 半角英数32桁 固定
取引ID
|
|
|---|---|---|
| Token | 半角英数記号256桁
トークン
|
|
| StartURL | 半角英数記号256桁
支払手続き開始IFのURL
|
|
レスポンスパラメータ：正常系
AccessID=a6a6b0061347e90cdef806b39bd28705&Token=wpd8A+R8uWZt+GnF6auJtMZNSB4yzSCZR9xdztqdBjGwBS7yYvxSiC0zeMVH+O4F&StartURL=https://x01.mul-pay.jp/payment/UnionpayStart.idPassレスポンスパラメータ：異常系
ErrCode=E01&ErrInfo=E01040001UnionpayStart 支払手続き開始IFの呼び出し
お客様をネット銀聯の決済画面へ遷移させる必要があります。 ※取引が特定できない場合、すでに支払いを済ませている場合、支払期限切れの場合等はエラー画面を表示します。
リクエスト
| AccessID | 必須 半角英数32桁 固定
取引ID
|
|
|---|---|---|
| Token | 必須 半角英数記号256桁
トークン
|
|
リダイレクトページサンプル
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-31J">
</head>
<body OnLoad='OnLoadEvent();'>
<form name="UnionpayStartCall" action="{決済実行のレスポンスで返却した接続先URL}" method="POST">
<noscript>
<br>
<br>
<center>
<h2>ネット銀聯の決済画面へ遷移します。</h2>
<input type="submit" value="続行">
</center>
</noscript>
<input type="hidden" name="AccessID" value="{AccessID}">
<input type="hidden" name="Token" value="{Token}">
</form>
<script>
<!--
function OnLoadEvent() {
document.UnionpayStartCall.submit();
}
//-->
</script>
</body>
</html>リダイレクト後、お客様はネット銀聯ログイン画面へ遷移します。